home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / rectcopy.z / rectcopy
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrreeeeccccttttccccooooppppyyyy((((3333GGGG))))                                                      rrrreeeeccccttttccccooooppppyyyy((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrreeeeccccttttccccooooppppyyyy - copies a rectangle of pixels with an optional zoom
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd rrrreeeeccccttttccccooooppppyyyy((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222,,,, nnnneeeewwwwxxxx,,,, nnnneeeewwwwyyyy))))
  13.      SSSSccccrrrreeeeeeeennnnccccoooooooorrrrdddd xxxx1111,,,,yyyy1111,,,, xxxx2222,,,, yyyy2222,,,, nnnneeeewwwwxxxx,,,, nnnneeeewwwwyyyy;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _x_1     expects the x coordinate of one corner of the rectangle.
  17.  
  18.      _y_1     expects the y coordinate of one corner of the rectangle.
  19.  
  20.      _x_2     expects the x coordinate of the opposite corner of the rectangle.
  21.  
  22.      _y_2     expects the y coordinate of the opposite corner of the rectangle.
  23.  
  24.      _n_e_w_x   expects the x coordinate of the lower-left corner of the new
  25.             position of the rectangle.
  26.  
  27.      _n_e_w_y   expects the y coordinate of the lower-left corner of the new
  28.             position of the rectangle.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      rrrreeeeccccttttccccooooppppyyyy copies a rectangular array of pixels (_x_1, _y_1, _x_2, _y_2) to another
  32.      position on the screen.  The current viewport and screenmask mask the
  33.      drawing of the copied region.  Self-intersecting copies work correctly in
  34.      all cases.
  35.  
  36.      Use rrrreeeeaaaaddddssssoooouuuurrrrcccceeee to specify the front buffer, the back buffer, the z-
  37.      buffer, or the optional Live Video Digitizer frame buffer as the source.
  38.      When using the Live Video Digitizer as the readsource, the coordinate
  39.      arguments should be specified relative to a video origin of (0,0).
  40.  
  41.      On machines that support it, you can use rrrreeeeccccttttzzzzoooooooommmm to independently zoom
  42.      the destination in both the _x and _y directions. Self-intersecting copies
  43.      with zoom also work correctly. Likewise, on machines that support it,
  44.      ppppiiiixxxxmmmmooooddddeeee can be used to greatly affect the copy operation.  Pixel shifts,
  45.      reflections, and numeric offsets are all possible.
  46.  
  47.      Use ffffrrrroooonnnnttttbbbbuuuuffffffffeeeerrrr, bbbbaaaacccckkkkbbbbuuuuffffffffeeeerrrr, and zzzzddddrrrraaaawwww to specify the destination.  All
  48.      coordinates are relative to the lower-left corner of the window.
  49.  
  50.      The result of rrrreeeeccccttttccccooooppppyyyy is undefined if zzzzbbbbuuuuffffffffeeeerrrr is TRUE, except when pixel
  51.      mode PPPPMMMM____ZZZZDDDDAAAATTTTAAAA is enabled (see ppppiiiixxxxmmmmooooddddeeee).  This special pixel mode, in
  52.      conjunction with stencil operation, can be used to implement rectangle
  53.      copies with depth buffering.
  54.  
  55.      rrrreeeeccccttttccccooooppppyyyy always operates within the currently active framebuffer, as
  56.      specified by ddddrrrraaaawwwwmmmmooooddddeeee.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeccccttttccccooooppppyyyy((((3333GGGG))))                                                      rrrreeeeccccttttccccooooppppyyyy((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      rrrreeeeccccttttccccooooppppyyyy leaves the current character position unpredictable
  75.  
  76. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  77.      pixmode, readsource, rectzoom, stencil
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      This subroutine is available only in immediate mode.
  81.  
  82.      The Live Video Digitizer option is available only on the IRIS-4D GTX.
  83.  
  84. BBBBUUUUGGGGSSSS
  85.      Pixel format is not considered during the copy.  For example, if you copy
  86.      pixels that contain color index data into an RGB window, the display
  87.      subsystem cannot correctly interpret it.
  88.  
  89.      On IRIS-4D GTX models the zoom factor is not applied when reading from
  90.      the Live Video Digitizer's frame buffer.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.